Saltar al contenido principal
GET
/
stores
/
{id}
Obtener tienda
curl --request GET \
  --url https://api.example.com/stores/{id}
{
  "data": {
    "id": "cocina-centro",
    "uid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "brand_id": "0001",
    "name": "Cocina Centro",
    "status": "ACTIVE",
    "timezone": "America/Guayaquil",
    "contact": {
      "email": "centro@comercio.com",
      "phone": "+593991234567"
    },
    "location": {
      "latitude": -2.1894,
      "longitude": -79.8891,
      "address_line_1": "Av. 9 de Octubre 123",
      "city": "Guayaquil",
      "country": "Ecuador",
      "postal_code": "090101",
      "business_name": "Cocina Centro S.A."
    },
    "channels": {
      "APP": {
        "id": "app",
        "uid": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
        "name": "App móvil",
        "fulfillment": {
          "PICKUP": {
            "uid": "c3d4e5f6-a7b8-9012-cdef-123456789012",
            "id": "pickup",
            "type": "PICKUP",
            "name": "Pickup",
            "pricing": {
              "is_tax_inclusive": true,
              "minimum_order_value": 0,
              "maximum_order_value": 500,
              "tax_rate": 0.15,
              "fees": []
            },
            "coverage_zones": [],
            "availability": {
              "status": "OPEN",
              "schedules": [{
                "monday": { "start_time": "09:00:00", "end_time": "22:00:00" },
                "tuesday": { "start_time": "09:00:00", "end_time": "22:00:00" },
                "wednesday": { "start_time": "09:00:00", "end_time": "22:00:00" },
                "thursday": { "start_time": "09:00:00", "end_time": "22:00:00" },
                "friday": { "start_time": "09:00:00", "end_time": "22:00:00" }
              }]
            }
          }
        }
      }
    },
    "payments": {
      "orderable": true,
      "methods": []
    },
    "cms_template_id": null,
    "cms": null,
    "overrides": []
  }
}
Devuelve la configuración completa de una tienda. Usa este endpoint después de que el cliente elija una ubicación para cargar opciones de fulfillment, disponibilidad por canal y métodos de pago en el checkout.
Requiere un access token de Fire spark obtenido mediante intercambio de token.

​
Headers

HeaderRequeridoDescripción
x-brand-idNoFiltra tiendas por marca. Identificador externo de la marca — solo alfanuméricos, _ y -. 1–64 caracteres. Si se omite, se devuelven todas las tiendas del comercio.

​
Parámetros de ruta

ParámetroRequeridoDescripción
idSíIdentificador externo de la tienda. Solo alfanuméricos, _ y -. 1–64 caracteres.

​
Solicitud

curl "https://firespark.vercel.app/api/storefront/v1/stores/cocina-centro" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "x-brand-id: 0001"

​
Respuesta

La respuesta envuelve un objeto tienda en data. La estructura coincide con el endpoint de listar tiendas. 
{
  "data": {
    "id": "cocina-centro",
    "uid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "brand_id": "0001",
    "name": "Cocina Centro",
    "status": "ACTIVE",
    "timezone": "America/Guayaquil",
    "contact": {
      "email": "centro@comercio.com",
      "phone": "+593991234567"
    },
    "location": {
      "latitude": -2.1894,
      "longitude": -79.8891,
      "address_line_1": "Av. 9 de Octubre 123",
      "city": "Guayaquil",
      "country": "Ecuador",
      "postal_code": "090101",
      "business_name": "Cocina Centro S.A."
    },
    "channels": {
      "APP": {
        "id": "app",
        "uid": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
        "name": "App móvil",
        "fulfillment": {
          "PICKUP": {
            "uid": "c3d4e5f6-a7b8-9012-cdef-123456789012",
            "id": "pickup",
            "type": "PICKUP",
            "name": "Pickup",
            "pricing": {
              "is_tax_inclusive": true,
              "minimum_order_value": 0,
              "maximum_order_value": 500,
              "tax_rate": 0.15,
              "fees": []
            },
            "coverage_zones": [],
            "availability": {
              "status": "OPEN",
              "schedules": [{
                "monday": { "start_time": "09:00:00", "end_time": "22:00:00" },
                "tuesday": { "start_time": "09:00:00", "end_time": "22:00:00" },
                "wednesday": { "start_time": "09:00:00", "end_time": "22:00:00" },
                "thursday": { "start_time": "09:00:00", "end_time": "22:00:00" },
                "friday": { "start_time": "09:00:00", "end_time": "22:00:00" }
              }]
            }
          }
        }
      }
    },
    "payments": {
      "orderable": true,
      "methods": []
    },
    "cms_template_id": null,
    "cms": null,
    "overrides": []
  }
}

​
Campos de la tienda

Consulta la referencia de listar tiendas para el esquema completo, incluyendo contact, location, channels, payments, cms_template_id, cms y overrides.
Revisa channels[canal].fulfillment[tipo].availability.status antes de mostrar el checkout. Una tienda puede estar OPEN para un tipo de fulfillment y TEMPORARILY_CLOSED para otro.

​
Respuestas de error

EstadoDescripción
401Access token ausente o inválido.
403El token no tiene acceso a esta tienda.
404No existe una tienda con el id indicado, o la tienda no pertenece a la marca del header x-brand-id.